home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_curl.idb / usr / freeware / catman / p_man / cat3 / curl_getdate.Z / curl_getdate
Text File  |  2002-07-08  |  4KB  |  107 lines
  1. curl_getdate(3)          libcurl Manual      curl_getdate(3)
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        curl_getdate - Convert an date in a ASCII string    to number
  7.        of seconds since    January    1, 1970
  8.  
  9. SSYYNNOOPPSSIISS
  10.        ##iinncclluuddee    <<ccuurrll//ccuurrll..hh>>
  11.  
  12.        ttiimmee__tt ccuurrll__ggeettddaattee((cchhaarr    **_d_a_t_e_s_t_r_i_n_g,, ttiimmee__tt **_n_o_w_"));;
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        This function returns the number    of seconds since  January
  16.        1st 1970, for the date and time that the    _d_a_t_e_s_t_r_i_n_g param
  17.        eter specifies. The _n_o_w parameter is there and should hold
  18.        the  current time to allow the datestring to specify rela
  19.        tive dates/times. Read further in the date  string  parser
  20.        section below.
  21.  
  22. PPAARRSSIINNGG    DDAATTEESS AANNDD TTIIMMEESS
  23.        A  "date"  is  a     string,  possibly empty, containing many
  24.        items separated by  whitespace.     The  whitespace  may  be
  25.        omitted    when no    ambiguity arises.  The empty string means
  26.        the beginning of    today (i.e.,  midnight).   Order  of  the
  27.        items  is immaterial.  A    date string may    contain    many fla
  28.        vors of items:
  29.  
  30.        ccaalleennddaarr    ddaattee iitteemmss
  31.            This can    be specified in     a  number  of    different
  32.            ways.  Including     1970-09-17,  70-9-17,    70-09-17,
  33.            9/17/72,    24 September 1972, 24 Sept 72, 24 Sep 72,
  34.            Sep  24,     1972,    24-sep-72, 24sep72.  The year can
  35.            also be omitted,    for example: 9/17 or "sep 17".
  36.  
  37.        ttiimmee ooff tthhee ddaayy iitteemmss
  38.            This string specifies the time  on  a  given  day.
  39.            Syntax supported    includes: 18:19:0, 18:19, 6:19pm,
  40.            18:19-0500 (for specifying the time zone    as well).
  41.  
  42.        ttiimmee zzoonnee iitteemmss
  43.            Specifies international time zone. There    are a few
  44.            acronyms    supported,  but     in  general  you  should
  45.            instead use the specific    realtive time compared to
  46.            UTC. Supported formats include: -1200, MST, +0100.
  47.  
  48.        ddaayy ooff tthhee wweeeekk iitteemmss
  49.            Specifies  a day    of the week. If    this is    mentioned
  50.            alone it    means that day of the week in the future.
  51.  
  52.            Days of the week    may be spelled out in full: `Sun
  53.            day', `Monday', etc or they may be abbreviated  to
  54.            their  first three letters, optionally followed by
  55.            a period.  The special  abbreviations  `Tues'  for
  56.            `Tuesday',  `Wednes' for    `Wednesday' and    `Thur' or
  57.            `Thurs' for `Thursday' are also allowed.
  58.  
  59.            A number    may precede a day of  the  week     item  to
  60.            move forward supplementary weeks.  It is    best used
  61.            in expression like `third monday'.  In  this  con
  62.            text, `last DAY'    or `next DAY' is also acceptable;
  63.            they move one week before or after  the    day  that
  64.            DAY by itself would represent.
  65.  
  66.        rreellaattiivvee    iitteemmss
  67.            A  relative  item  adjusts  a date (or the current
  68.            date if none) forward or    backward. Example  syntax
  69.            includes:  "1  year",  "1  year ago", "2    days", "4
  70.            weeks".
  71.  
  72.            The string `tomorrow' is     worth    one  day  in  the
  73.            future  (equivalent to `day'), the string `yester
  74.            day' is worth one day in    the past  (equivalent  to
  75.            `day ago').
  76.  
  77.        ppuurree nnuummbbeerrss
  78.            If  the decimal number is of the    form YYYYMMDD and
  79.            no other    calendar date item appears before  it  in
  80.            the date    string,    then YYYY is read as the year, MM
  81.            as the month number and    DD  as    the  day  of  the
  82.            month, for the specified    calendar date.
  83.  
  84.  
  85. RREETTUURRNN VVAALLUUEE
  86.        This function returns zero when it fails    to parse the date
  87.        string. Otherwise it returns  the  number  of  seconds  as
  88.        described.
  89.  
  90. AAUUTTHHOORRSS
  91.        Originally     written      by     Steven       M.     Bellovin
  92.        <smb@research.att.com> while at the  University    of  North
  93.        Carolina     at  Chapel  Hill.   Later tweaked by a    couple of
  94.        people on Usenet.   Completely  overhauled  by  Rich  $alz
  95.        <rsalz@bbn.com>     and   Jim  Berets  <jberets@bbn.com>  in
  96.        August, 1990.
  97.  
  98. SSEEEE AALLSSOO
  99.  
  100.  
  101. BBUUGGSS
  102.        Surely there are    some, you tell me!
  103.  
  104.  
  105.  
  106. libcurl    7.0           5 March 2001          curl_getdate(3)
  107.